lz(matrix, ip = NA, model = "2PL", ability = NA, method = "ML", mu = 0, sigma = 1)
lzstar(matrix, ip = NA, model = "2PL", method = "ML", mu = 0, sigma = 1)
ip=NA
). The options available are "1PL"
, "2PL"
(default), and "3PL"
.matrix
.
In case no ability parameters are available then ability=NA
.ability=NA
for lz
). The options available are "ML"
(default), "BM"
, and "WL"
.method="BM"
. Default is 0.method="BM"
. Default is 1.lz
. This statistic is the standardized log-likelihood of the respondent's response vector. lz
is (supposed to be) asymptotically standard normally distributed.
The computation of lz
requires that both item and ability parameters are available. Function lz
allows to user to enter his/her own item and ability parameter estimates (variables ip
and ability
, respectively). Alternatively, lz
relies on functions available through the irtoys
package for estimating the parameters. Specifically, the user can choose one from three possible IRT models to fit the data: model="1PL"
, model="2PL"
, or model="3PL"
. As for estimating the ability parameters there are three possible methods: method="ML"
(maximum likelihood), method="BM"
(Bayes modal), or method="WL"
(weighted likelihood).
It was later observed by several researchers (e.g., Molenaar and Hoijtink, 1990) that the asymptotic approximation only holds when true ability values are used. This limitation was overcome by Snijders (2001), who further developed lz
into the lzstar
statistic. An accessible paper that thoroughly explains the basic principles behind lzstar
is Magis, Raiche, and Beland (2012). It is important to realize that not all item and/or ability estimation procedures can be used when computing lzstar
. In particular, the estimation of the ability parameters is constrained (see Snijders, 2001, Equation 5). The lzstar
algorithm internally estimates the ability parameters accordingly for one of three possible methods: method="ML"
(maximum likelihood), method="BM"
(Bayes modal), or method="WL"
(weighted likelihood), see Magis et al. (2012).
Aberrant response behavior is (potentially) indicated by small values of lz/lzstar (i.e., in the left tail of the sampling distribution).lzpoly
# Load the inadequacy scale data (dichotomous item scores):
data(InadequacyData);
# Compute the lz scores using a subsample of the first 200 response vectors:
lz(InadequacyData[1:200,]);
# Compute the lzstar scores using a subsample of the first 200 response vectors:
lzstar(InadequacyData[1:200,]);
Run the code above in your browser using DataLab